home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / applic / NCSA_Telnet / tn3270 / wmac.helpcms < prev    next >
Encoding:
Text File  |  1989-11-19  |  9.8 KB  |  190 lines
  1. .fo off
  2. .cs 1 on
  3.  
  4. WMAC
  5.  
  6. Use  the WMAC  command to  download CMS  files  to the  Macintosh.   WMAC  will
  7. download text files,  binary files,  and binary files in MacBinary format.   In
  8. order to use WMAC,  the Macintosh must  be running Term for a modem connection,
  9. Mac3270 for a LocalTalk connection, or tn3270 for a TCP/IP connection.
  10. .cs 1 off
  11. .cs 2 on
  12. The format of the WMAC command is:
  13.  
  14. ┌──────────╛──────────────────────────────────────────────────────────────────┐
  15. │          │                                                                  │
  16. │ WMAC     │ fn ft [fm]   [(options...[)]]                                    │
  17. │          │                                                                  │
  18. │          │ Options:                                                         │
  19. │          │     ┌           ┐  ┌           ┐  ┌           ┐                  │
  20. │          │     │Ascii      │  │Binary     │  │Macbin     │                  │
  21. │          │     │MEnu       │  │Noascii    │  │NOBinary   │                  │
  22. │          │     │NOMacbin   │  │NOMEnu     │  │Print      │                  │
  23. │          │     │Stdxlate   │  │Text       │  │TRuncate   │                  │
  24. │          │     └           ┘  └           ┘  └           ┘                  │
  25. │          │                                                                  │
  26. └──────────╩──────────────────────────────────────────────────────────────────┘
  27. .cs 2 off
  28. .cs 3 on
  29.  
  30. OPERANDS
  31.  
  32. fn        specifies the filename of the file to be downloaded.
  33.  
  34. ft        specifies the filetype  of the file to be downloaded.    If the first
  35.           character of the filetype  is a period,  a period instead  of a space
  36.           will separate  the CMS filename  and filetype  when they are  used to
  37.           form the Macintosh file name.   However,   the period will be ignored
  38.           when searching for a matching CMS file.
  39.  
  40. fm        specifies the filemode  of the file to be downloaded.    When "fm" is
  41.           omitted or specified as "*",  all accessed disks will be searched for
  42.           a file matching "fn" and "ft".
  43.  
  44. OPTIONS
  45.  
  46. Ascii     specifies the file  to be downloaded contains plain  text.   The file
  47.           will  be converted  from EBCDIC  text in  CMS  to ASCII  text on  the
  48.           Macintosh.   Line breaks  in the CMS file will become  line breaks in
  49.           the Macintosh file.  This is the default type of transfer.
  50.  
  51. Binary    specifies the file  to be downloaded contains  arbitrary binary data.
  52.           The contents  of the  file will be  downloaded unchanged,   with line
  53.           divisions in the CMS file ignored.
  54.  
  55. Macbin    specifies the  file to be downloaded  contains the binary image  of a
  56.           Macintosh file in MacBinary format.   As the file is downloaded,  the
  57.           MacBinary  format  will  be  interpreted   to  restore  the  original
  58.           Macintosh file.
  59.  
  60. MEnu      specifies that a  standard Macintosh file dialog be  issued to define
  61.           the name and location of the downloaded file.  This is the default.
  62.  
  63. Noascii
  64.  
  65. NOBinary
  66.  
  67. NOMacbin  reset the Ascii,  Binary,  or Macbin options described above.   If an
  68.           option is set, then reset by a subseuqent option,  WMAC behaves as if
  69.           the option were never used.
  70.  
  71. NOMenu    suppresses issuing a standard file dialog  on the Macintosh to select
  72.           the name and  destination of the downloaded file.   The  file will be
  73.           written to the current disk or folder, using the same name as the CMS
  74.           file, but with upper case letters translated to lower case.
  75.  
  76. Print     causes the  specified file  to be  printed on  the printer  currently
  77.           selected  on the  Macintosh,  instead  of being  downloaded to  disk.
  78.           Formatting  on the  printer is  controlled by  the Macintosh  program
  79.           (tn3270,  Term,  or  Mac3270).   See the program's  documentation for
  80.           additional information.
  81.  
  82. Stdxlate  causes the standard  IBM ASCII/EBCDIC translation tables  to be used,
  83.           instead of the modified tables which are the default at Brown.
  84.  
  85. Text      specifies that  the file to be  downloaded contains ASCII  text,  but
  86.           that line  breaks and  trailing blanks  are not  significant.   Blank
  87.           lines in  the CMS file  will result in  line breaks in  the Macintosh
  88.           file.   See "Using the WMAC Command" below for more information about
  89.           this option.
  90.  
  91. TRuncate  specifies that  trailing blanks are to  be deleted from lines  as the
  92.           file is downloaded.   If a line contains only blanks,  the downloaded
  93.           file will contain a null (zero-length) line.
  94.  
  95. USING THE WMAC COMMAND
  96.  
  97. When downloading files,  WMAC will treat a CMS file in one of three ways:  as a
  98. text file,  a binary file,  or a  MacBinary file.   Text file processing is the
  99. default, and is appropriate for most ordinary files.   Downloading in this mode
  100. causes EBCDIC text to be translated to ASCII text on the Macintosh,  and causes
  101. line breaks to be preserved.
  102.  
  103. Binary mode,  invoked by the Binary option,  causes the data in the CMS file to
  104. be downloaded  completely unchanged.   No  translation is performed,   and line
  105. breaks in the CMS file are ignored.   This mode is approriate when transferring
  106. a file  in an  application-specific format  between different  computers.   For
  107. example,  it  could be used  to download a MicroSoft  Word file which  had been
  108. uploaded in  binary mode  from an  IBM PC.    In general,   if the  file to  be
  109. downloaded contains unreadable  characters,  and it is not  in MacBinary format
  110. (see below), then it should be downloaded using binary mode.
  111.  
  112. The third mode, MacBinary, is invoked by the Macbin option.   This mode is used
  113. to download files which contains the data,  resources,  and control information
  114. for a Macintosh file,   encoded in the standard MacBinary format.    In CMS,  a
  115. MacBinary file usually contains "BIN" as all or part of its filetype, and has a
  116. record  length which  is a  multiple of  128.    When files  are downloaded  in
  117. MacBinary  mode,  the  MacBinary format  is decoded  in order  to recreate  the
  118. original Macintosh file, including its icon, and other attributes.
  119.  
  120. When WMAC is downloading  a text file,  it ordinarily inserts  line breaks into
  121. the Macintosh  file wherever  they appear in  the CMS  file.   Line  breaks are
  122. approriate  for  many Macintosh  applications,   but  are interpreted  by  word
  123. processing programs to indicate the start of a new paragraph.   Use of the Text
  124. option  will cause  WMAC to  convert  the CMS  file  to the  proper format  for
  125. Macintosh word processing.   With this option,  line breaks and trailing blanks
  126. in the CMS  file are ignored.   Line  breaks will be inserted  in the Macintosh
  127. file only  when blank lines  appear in the CMS  file.   In general,   WMAC will
  128. attempt to convert what  appear to be paragraphs in the  CMS file to paragraphs
  129. in the word processing file.
  130.  
  131. USAGE NOTES
  132.  
  133.   1) If a  file transfer  does not  begin after  the WMAC  command is  entered,
  134.      either file transfer  is not enabled in the Macintosh  program (applies to
  135.      Term  only),  or  the communication  path  between the  Macintosh and  the
  136.      mainframe does  not support a feature  WMAC requires (applies to  Term and
  137.      tn3270).  For Term, if a 3270 emulator is being used, it must support 7171
  138.      transparent I/O  or its  equivalent.   For  tn3270,  the  mainframe Telnet
  139.      server must support  3270 extended data streams.   To  resume the terminal
  140.      session,  press Enter  several times,  until WMAC responds  with the error
  141.      message "Retry count exceeded".
  142.  
  143.   2) When downloading all but MacBinary files,  WMAC preserves the date the CMS
  144.      file was last written.  The date is used to set both the creation and last
  145.      modified dates of the Macintosh file.   For a MacBinary file, the creation
  146.      and last modified dates are set from the values found in the file.
  147.  
  148.   3) WMAC  only writes  to  the  data fork  of  Macintosh  files,  except  when
  149.      downloading a  MacBinary file.   For MacBinary  files,  both the  data and
  150.      resource forks are decoded and written.
  151.  
  152. RESPONSES
  153.  
  154. Enter ABORT, CONTINUE, or SUBSET
  155.  
  156.           This response is generated when the user chooses "Interrupt Transfer"
  157.           on the Macintosh.    By entering one of the  three allowed responses,
  158.           the use can abort the file  transfer,  resume the transfer,  or enter
  159.           CMS SUBSET.   If CMS SUBSET is entered, the file transfer will resume
  160.           upon returning from SUBSET.
  161.  
  162. OTHER MESSAGES AND RETURN CODES
  163.  
  164.      DMSWMC002E File 'fn ft fm' not found.  RC=28
  165.      DMSWMC003E Invalid option 'xxxxxxxx',  RC=24
  166.      DMSWMC004E Mac error nnnn opening 'fileid'.  RC=100+Mac return code
  167.      DMSWMC005E Mac file 'fileid' already exists.  RC=100+Mac return code
  168.      DMSWMC006E Error ...... from Mac write.  RC=100+Mac return code
  169.      DMSWMC007E Retry count exceeded.  RC=256
  170.      DMSWMC008I nnnnnn block retransmission(s).
  171.      DMSWMC009E Error nnnnnn from Mac close.  RC=100+Mac return code
  172.      DMSWMC010E Error from CP "SET" command.  RC=return code from CP
  173.      DMSWMC010E Error from CP "TERM" command.  RC=return code from CP
  174.      DMSWMC010E Remote system type is unknown.  RC=36
  175.      DMSWMC011E This version of Mac3270 (nn.nn) does not support file
  176.                 transfer.  RC=36
  177.      DMSWMC011E Transfer aborted by used.  RC=100+Mac return code
  178.      DMSWMC012E This version (nn.nn) of Mac3270 or Term does not support
  179.                 the requested transfer type.  RC=36
  180.      DMSWMC013E File transfer cancelled by user.  RC=24
  181.      DMSWMC014E File 'fn ft fm' is not in MacBinary format.  RC=32
  182.      DMSWMC054E Incomplete fileid specified.  RC=24
  183.      DMSWMC066E 'ASCII' and 'BINARY' or 'MACBIN' are conflicting options.
  184.                 RC=24
  185.      DMSWMC069E Disk 'mode' not accessed.  RC=36
  186.      DMSWMC104S Error 'nnnnn' reading file 'fn ft fm' from disk.  RC=100
  187.      DMSWMC109S Virtual storage capacity exceeded.  RC=104
  188.  
  189. .cs 3 off
  190.